Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 7 - Finder Interface Reference / Finder Interface Functions

Manipulating Folder Descriptors /

InvalidateFolderDescriptorCache

NEW WITH MAC OS 8

Invalidates the cache of results from the Folder Manager's previous calls to the FindFolder function in order to force the Folder Manager to reexamine the disk when FindFolder is called again on the specified directory ID or volume reference number.

pascal OSErr InvalidateFolderDescriptorCache (
                     short vRefNum,
                     long dirID);

vRefNum

The volume reference number (or the constant kOnSystemDisk for the startup disk) of the volume containing the folder for which you wish the descriptor cache to be invalidated. Pass 0 in this parameter to completely invalidate all folder cache information.

dirID

The directory ID number for the folder for which you wish the descriptor cache to be invalidated. Pass 0 to invalidate the cache for all folders on the specified disk.

function result

A result code; see "Result Codes".

DISCUSSION

The InvalidateFolderDescriptorCache function takes a volume reference number and a directory ID and searches to see if it is currently referred to as a cached target of folder resolution. If it is found, it is removed as the cached value, but the folder descriptor is otherwise left unchanged. You should not normally need to call InvalidateFolderDescriptorCache.

SPECIAL CONSIDERATIONS

Before calling the InvalidateFolderDescriptorCache function, you must pass the selector gestaltFindFolderAttr to the Gestalt function. If the gestaltFolderDescSupport bit is set, InvalidateFolderDescriptorCache is available.